home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / viewers / vx38613 / vx386.doc < prev    next >
Encoding:
Text File  |  1993-01-31  |  12.3 KB  |  321 lines
  1.  
  2. The author makes NO WARRANTY or representation, either express or implied,
  3. with respect to this software, its quality, accuracy, merchantability, or
  4. fitness for a particular purpose.  This software is provided "AS IS", and you,
  5. its user, assume the entire risk as to its quality and accuracy.
  6.  
  7. Here is vx386 v1.3, the image viewer that lets you look at the current image
  8. in a slide show while decoding the next one to extended memory.  When
  9. you hit the ENTER or SPACE key, it (almost) immediately displays the
  10. pre-decoded image, and automatically decodes the next one in the slide
  11. show.  This way, you don't have to wait.  The first image in the show is
  12. sent to the screen while it's being decoded.  It can also look for the
  13. images in multiple directories that you specify on the command line.
  14.  
  15. vx386 is a 32-bit extended dos program.  It runs in 386 protected mode.
  16. It uses a flat 32bit address space and 32bit instructions for speed.
  17. It was compiled with the Intel's 386/486 C Code Builder (TM) compiler,
  18. which I highly recommend. The dos extender is DPMI compliant, so it
  19. will run in a fullscreen dos session under MS Windows(TM).  vx386 is the
  20. fastest GIF decoder I have ever tested. The JPEG decoder uses the
  21. Idependent JPEG Group's JPEG software.  It is the best JPEG
  22. implementation around.
  23.  
  24. vx386 requires a 386 or better CPU, 1.5-2.0 MB free extended memory, and
  25. one of the following video boards:
  26.  
  27. Diamond Speedstar 24X
  28.  
  29. It will display JPEG, 24bit rgb TARGA, and GIF87a or GIF89a files,
  30. but it cannot do the fancy GIF89 stuff.  Note, some comercial packages
  31. use proprietary JPEG formats.  vx386 supports JFIF and the "baseline"
  32. JPEG formats, which are the most commonly used formats for distributing
  33. JPEG images.  If you are having trouble viewing TARGA files, make sure
  34. they are in 24bit unmapped, uncompressed rgb format.  This is the
  35. default format of PICLAB, the Imager program that comes with the 24X,
  36. and DJPEG.  PBMPLUS also supports this format.  vx386 will now display
  37. upside-down targas right-side up.
  38.  
  39. vx386 is shareware.  If you use it beyond the 10 day trial
  40. period, please send $20 US to:
  41.  
  42. Bailey Brown
  43. 188 Morris Rd
  44. Toney, Alabama 35773 USA
  45.  
  46. e-mail:
  47.  
  48. 73020,3442                    (CompuServe)
  49.  
  50. This initial release definitely has bugs in it.  I took my real mode
  51. gif viewer, SGIF, and ported it to 32bit extended dos, then added targa
  52. and jpeg support as quickly as possible.  I will fix bugs as soon as
  53. I find them, but I would like to get this thing uploaded so people
  54. can start using their spanking new 24X boards to the full extent of
  55. their image viewing capabilities from dos.
  56.  
  57. One neat feature of vx386 is that it allows you to specify multiple
  58. paths on the command line, so that you can browse through all of your
  59. images at once, even if they are split among several directories.
  60.  
  61. It has a very good interactive slideshow capability.  You can return to the
  62. previous image, reverse direction, remove files from the slideshow, have
  63. an automatic slideshow and specify the delay between pictures, pause an
  64. automatic slideshow, and preview a image without clearing your current
  65. slideshow selections.
  66.  
  67. Your can switch resolutions on the fly.  In this case, the image is copied
  68. from the screen to extended memory, then the mode is switched, then the
  69. image is displayed, saving you the decoding time.
  70.  
  71. It will use the higher text modes (80x50, 132x25, 132x44) if they are needed
  72. to display all of the files on the screen.
  73.  
  74.  
  75. A more complete description of the features follows.
  76.  
  77. Version History:
  78.  
  79. 1.3
  80.  
  81. Added detection of and support for upside-down targas.  Also
  82. fixed a bug that was probably causing a line of garbage pixels to
  83. appear in one vertical scanline while viewing some targas.
  84.  
  85. 1.2
  86. Got rid of extensions on filenames.  Now gif filenames are shown in
  87. white, jpegs in red, and targas in cyan.  This allows vx386 to display
  88. 572 filenames at once in 132x44 mode.  The /c option is now defunct.
  89. Program now prings "no files found" message when no image files are
  90. found in current dir or in /d path.
  91.  
  92. 1.1
  93. Put delay between frames in slideshow option back in (/Wn).
  94. Fixed problem with displaying some images larger than
  95. 640x480 in 32K mode.
  96.  
  97. 1.0
  98. Initial version.
  99.  
  100.  
  101. COMMAND LINE OPTIONS (not case sensitive)
  102. =========================================
  103.  
  104. * means default
  105.  
  106. /X[S|N]  Tells vx386 you have a Diamond Speestar 24X.  This switch is
  107.          neccessary because vx386 will detect a 24X as a Paradise SVGA.
  108.          It will still work in this case, but you will not be able to
  109.          use the 24X's extended modes.
  110.  
  111.          The 'S' option tells vx386 to check for snow in 1024x768x256 mode
  112.          when decoding the first image in a slideshow to the screen, one
  113.          scanline at a time.  Snow checking is never needed otherwise.
  114.  
  115.          Then 'N' option tells it not to check for snow.  It is best
  116.          to try it this way first.
  117.  
  118.  
  119. /V[:]x    default screen dimensions (colon is optional) where x is one of the
  120.           following:
  121.  
  122.           *default (no /v option given) is to use automode, meaning
  123.            lowest mode that will show whole picture is used.
  124.  
  125.            letter       horizontal      vertical        colors
  126.  
  127.            R            640             400             256
  128.            S            640             480             256 or 16.7M*
  129.            T            800             600             256 or 32K*
  130.            X           1024             768             256
  131.            1            next higher resolution than the one that
  132.                         the image will fit in, eg 800x600 for 640x480 images
  133.                         and 1024x768 for 800x600 images.
  134.  
  135. * vx386 uses 256 for gifs or true/hicolor for targa/jpeg at these resolutions.
  136.  
  137. /B[d|n]  Background color
  138.  
  139.        *none   use background color specified in the gif header
  140.                 (not necessarily color 0 from the color map, which
  141.                 most gif viewers do).
  142.  
  143.         D      find darkest color in colormap and use it for the background
  144.  
  145.         n      where n is a number.  Use color n in the color map for
  146.                the background.  n must be in the range [0-nn]  where nn
  147.                is one less than the number of colors in the image (usually
  148.                15 or 255).
  149.  
  150.                 examples:
  151.                 vx386       will use color from gif header
  152.                 vx386 /bd   will use darkest color possible
  153.                 vx386 /b0   will use color 0 (usually black)
  154.                 vx386 /b255 will use color 255 (usually white)
  155.  
  156. /Dpath1;path2;..;pathn
  157.  
  158.         specify Directories to look for images.  Does not assume current directory.
  159.  
  160.         example:
  161.  
  162.         vx386 /d.;c:\pix\people;c:\pix\places;c:\pix\things;..\morepix
  163.  
  164.         will allow you to select images from the current directory and
  165.         the directories c:\pix;people, c:\pix\places, c:\pix\things,
  166.         and ..\morepix.
  167.  
  168. /K      don't wait for Keypress between pictures (auto slideshow).
  169.  
  170. /Wn     Wait time.  Sets pause time to n 100ths of a second.
  171.         Useful with auto slideshow.
  172.  
  173. /R      Return to DOS after displaying picture.
  174.  
  175. /E      Leave picture on screen after exiting (don't clear screen).
  176.         Useful with /R option.
  177.  
  178. /C      Display filenames in colors corresponding to the directories they
  179.         are in so you can see which ones are in the same directory.
  180.  
  181. SELECTION KEYS (not case sensitive):
  182. ====================================
  183.  
  184. ENTER   show selected image(s).
  185.  
  186. SPACE   mark image for slideshow.
  187.  
  188. PAGE UP move to top of screen.
  189. PAGE DN move to bottom of screen.
  190. HOME    move to first column.
  191. END     move to last column.
  192. ^HOME   move to tope left corner.
  193. ^END    move to bottom right corner.
  194.  
  195. INSERT  allows you to insert new choices into the middle of your
  196.         selection list. Just go to the selected filename that you want
  197.         to come after the new selection, press the "insert" key, and
  198.         then select the new file in the regular fashion.  While "insert"
  199.         mode is activated, an 'I' will appear in the upper-right corner
  200.         of the screen.
  201.  
  202. 'f'     type 'f' followed by any char to move highlight to first filename
  203.         on screen that starts with that char.  Good for moving around
  204.         quickly.
  205.  
  206. 'p'     preview image (show image witout clearing slideshow list).
  207.  
  208. '+'
  209. 'z'
  210.         make next higher resolution default (starts with 640x480x256).
  211. '-'
  212. 'x'     make next lowere resolution default.
  213.  
  214. 'i'     display info on file (path, resolution, colors, size)
  215.  
  216. ^D      delete file after prompting
  217.  
  218. alt+s   shell out to  dos.  Type 'exit' and 'enter' to return to vx386.
  219.  
  220. toggles:
  221.  
  222. 'a'     use auto resolution.
  223.  
  224. '1'     use next higher than auto resolution, eg. 800x600 for 640x480 image.
  225.  
  226. 'd'     use darkest color in images as background.
  227.  
  228. 'k'     (don't) wait for keypress.
  229.  
  230. ESC     quit.
  231.  
  232.  
  233. INTERACTIVE KEYS (while viewing images)
  234. =======================================
  235.  
  236. '+'
  237. 'z'
  238.         change to next higher resolution.
  239. '-'
  240. 'x'
  241.         change to next lower resolution.
  242.  
  243. 'u'     unselect image, ie. remove it from slideshow.
  244.  
  245. 'i'     display info on file (path, resolution, colors, size)
  246.  
  247. ^D      delete file after prompting
  248.  
  249. BACKSPACE
  250.         go back to previous image
  251.  
  252. 'r'     reverse direction of slideshow.
  253.  
  254. ESC     stop decoding/viewing and return to selection menu.
  255.  
  256. toggles:
  257.  
  258. 'a'     use auto resolution.
  259.  
  260. '1'     use next higher than auto resolution, eg. 800x600 for 640x480 image.
  261.  
  262. 'd'     use darkest color in images as background.
  263.  
  264. 'k'     (don't) wait for keypress.
  265.  
  266. WINDOWS USERS WITHOUT 387
  267.  
  268. Included is a device driver, VEMD.386, which should be installed in
  269. your [386Enh] section of your windows system.ini file.  Put the line
  270.  
  271. device=c:\mypath\vemd.386
  272.  
  273. in that section.
  274.  
  275. VIRTUAL MEMORY NOTES
  276.  
  277. This program uses the virtual-memory scheme provided by Intel's Code Builder
  278. C compiler.  The program's working space consists of whatever extended memory
  279. is available, plus space in a temporary "swap file".  The total working space
  280. is called the "region".  If the programs run out of space when processing a
  281. large image, you can increase the region size as explained below.  Conversely,
  282. if you need to make the swap file smaller, you can decrease the region size.
  283.  
  284. As distributed, the program has a region size of 3 MB.  Thus, if you have
  285. 2 MB of free extended memory, the programs will create a 1 MB swap file upon
  286. startup.  If there isn't enough free disk space to create the swap file,
  287. you'll get an error message like this:
  288.     DOS Extender: Error X0130:  Failure detected during program load
  289. If this happens, you must free up some disk space or reduce the region size
  290. in order to run the program.  Another possibility is to put the swap file on a
  291. different disk drive that has more free space.  The default swap file is
  292.     C:\XMSWAP.TMP
  293. You can select a different swap file name/location by setting the SWAP
  294. environment variable, for example "set SWAP=D:\XMSWAP.TMP".
  295.  
  296. If you get an error message that looks like this:
  297.     Insufficient memory (case N)
  298. then you need to increase the region size in order to process your image.
  299.  
  300. The region size for each program is encoded in the program's .EXE file.
  301. To change the region size, run the provided MODXCONF program, for example
  302.         modxconf vx386.exe
  303. Follow the on-screen directions to change the region size.  (The stored region
  304. size is ignored if it is less than the available extended memory; in that case
  305. the programs always use all available extended memory.)
  306.  
  307. It is possible to pre-allocate a swap file.  This makes vx386 start
  308. up faster, since they don't have to create and delete the swap file.  However,
  309. the swap file then takes up space even when you are not using the program.
  310. If you want to create a pre-allocated swap file, run modxconf and follow its
  311. directions, or use any other method to create a file of the right name and
  312. size.  Note: when a pre-allocated swap file is present, the region size is
  313. determined by the available extended memory plus the swap file size; the
  314. region size stored in the .EXE file is ignored.
  315.  
  316. If you are running the programs in a DOS window under Windows 3.x (in 386
  317. enhanced mode), the programs do not allocate a swap file.  Instead, the amount
  318. of extended memory indicated by the region size is requested from Windows, and
  319. any swapping needed is handled by Windows using its swap file.
  320.  
  321.